home *** CD-ROM | disk | FTP | other *** search
-
-
-
- iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333))))
-
-
-
- NNNNAAAAMMMMEEEE
- iiiillllIIIImmmmggggSSSSttttaaaatttt - computes 1-D histogram, min, max, mean and standard deviation
- of an image
-
-
- IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
- ilLink
-
-
- HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
- #include <il/ilCdefs.h>
-
-
- CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- This class provides member functions that evaluate 1-D histograms,
- minimum, maximum, mean and standard deviation of an image. If no region
- of interest is specified, statistics are gathered over the entire image;
- otherwise, they are only gathered for the specified region. Along with
- the region of interest, one needs to specify the _x and _y offsets into the
- source image, at which the region of interest is to be placed. The mean
- and standard deviation are calculated from the histogram and so, in some
- cases, they may represent only approximate values. If the image has
- multiple channels, then the statistics for each channel are computed
- separately. Since this class is derived from the _i_l_L_i_n_k object, it can be
- a part of a multiply connected chain of objects with parent/child
- dependencies.
-
- The iiiillllIIIImmmmggggSSSSttttaaaatttt attempts to optimize the computation of statistics. In
- general, they will be computed once for any given setting of the control
- parameters (e.g., sssseeeettttLLLLiiiimmmmiiiittttssss()) and input image. Any changes to these
- parameters or the input image (or its predecessors) will result in
- recollection of statistics the next time they are retrieved.
-
- CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
- CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr
-
- ilImgStat* ilImgStatCreate(ilImage* img, ilRoi* roi, int xoffset,
- int yoffset, int zoffset=-1,
- int nz)
-
-
- MMMMaaaannnnaaaaggggiiiinnnngggg tttthhhheeee SSSSoooouuuurrrrcccceeee
-
- void ilImgStatSetInput(ilImgStat *obj, ilImage* in)
- ilImage* ilImgStatGetInput(ilImgStat *obj)
-
-
- MMMMaaaannnnaaaaggggiiiinnnngggg HHHHiiiissssttttooooggggrrrraaaammmm CCCCoooommmmppppuuuuttttaaaattttiiiioooonnnn
-
- void ilImgStatSetLimits(ilImgStat *obj, double start,
- double end)
- void ilImgStatClearLimits(ilImgStat *obj)
-
-
-
- PPPPaaaaggggeeee 1111
-
-
-
-
-
-
- iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333))))
-
-
-
- void ilImgStatSetBinCount(ilImgStat *obj, int count)
- double ilImgStatGetBinSize(ilImgStat *obj)
- void ilImgStatClearBinCount(ilImgStat *obj)
- void ilImgStatGetLimits(ilImgStat *obj, double* start,
- double* end)
- double ilImgStatGetStart(ilImgStat *obj)
- double ilImgStatGetEnd(ilImgStat *obj)
- int ilImgStatGetBinCount(ilImgStat *obj)
- unsigned long* ilImgStatGetHist(ilImgStat *obj, int chan)
-
-
- MMMMaaaannnnaaaaggggiiiinnnngggg tttthhhheeee RRRROOOOIIII
-
- void ilImgStatSetRoi(ilImgStat *obj, ilRoi* roi, int xoffset,
- int yoffset)
- void ilImgStatSetZ(ilImgStat *obj, int z, int nz)
- void ilImgStatClearZ(ilImgStat *obj)
- ilRoi* ilImgStatGetRoi(ilImgStat *obj)
-
-
- RRRReeeettttrrrriiiieeeevvvviiiinnnngggg OOOOtttthhhheeeerrrr SSSSttttaaaattttiiiissssttttiiiiccccssss
-
- double ilImgStatGetMin(ilImgStat *obj, int c)
- double ilImgStatGetMax(ilImgStat *obj, int c)
- double ilImgStatGetMean(ilImgStat *obj, int c)
- double ilImgStatGetStdDev(ilImgStat *obj, int c)
- unsigned long ilImgStatGetTotal(ilImgStat *obj, int c)
- double ilImgStatGetOverallMin(ilImgStat *obj, int c)
- double ilImgStatGetOverallMax(ilImgStat *obj, int c)
-
-
- CCCCaaaallllccccuuuullllaaaattttiiiinnnngggg SSSSttttaaaattttiiiissssttttiiiiccccssss
-
- void ilImgStatQCalcStats(ilImgStat *obj, ilMpNode* parent,
- ilMpManager** pMgr)
- void ilImgStatFreeze(ilImgStat *obj, int enable)
- int ilImgStatIsFrozen(ilImgStat *obj)
- void ilImgStatSetHwEnable(ilImgStat *obj, ilHwAccelEnable enable)
- ilHwAccelEnable ilImgStatGetHwEnable(ilImgStat *obj)
-
-
-
- FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
- iiiillllIIIImmmmggggSSSSttttaaaatttt(((())))
-
- ilImgStat* ilImgStatCreate(ilImage* img, ilRoi* roi, int xoffset,
- int yoffset, int zoffset=-1,
- int nz)
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 2222
-
-
-
-
-
-
- iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333))))
-
-
-
- The constructor takes a pointer to the source ilImage, _s_r_c, and an
- optional ilRoi pointer, _r_o_i. _x_o_f_f_s_e_t, _y_o_f_f_s_e_t and _z_o_f_f_s_e_t are the x,
- y and z offsets into _s_r_c, at which _r_o_i is to be placed. These
- offsets are specified in the same coordinate space as that of _s_r_c.
- The _n_z argument specifies the number of z planes over which
- statistics should be collected. By default statistics are covered
- for all z planes in the image within the current ROI.
-
- cccclllleeeeaaaarrrrBBBBiiiinnnnCCCCoooouuuunnnntttt(((())))
-
- void ilImgStatClearBinCount(ilImgStat *obj)
-
-
- Clears a previously set histogram bin count (see sssseeeettttBBBBiiiinnnnCCCCoooouuuunnnntttt()
- below). Following this call, the number of bins for the histogram
- will be computed automatically.
-
- cccclllleeeeaaaarrrrLLLLiiiimmmmiiiittttssss(((())))
-
- void ilImgStatClearLimits(ilImgStat *obj)
-
-
- Clears previously set input limits (see sssseeeettttLLLLiiiimmmmiiiittttssss() below). The new
- limits will be taken from the minimum and maximum values of the
- input image.
-
- cccclllleeeeaaaarrrrZZZZ(((())))
-
- void ilImgStatClearZ(ilImgStat *obj)
-
-
- Clears the previously set z bounds (see sssseeeettttZZZZ() below). The new
- bounds will be taken from the z bound of the input image.
-
- ffffrrrreeeeeeeezzzzeeee(((())))
-
- void ilImgStatFreeze(ilImgStat *obj, int enable)
-
-
- This method enables or disables the automatic statistics
- recalculation facility based upon _e_n_a_b_l_e. By default the statistics
- are automatically recomputed when requested by the application if
- the input image has changed.
-
- ggggeeeettttBBBBiiiinnnnCCCCoooouuuunnnntttt(((())))
-
- int ilImgStatGetBinCount(ilImgStat *obj)
-
-
- Returns the number of bins included in the collected histogram.
-
-
-
-
-
- PPPPaaaaggggeeee 3333
-
-
-
-
-
-
- iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333))))
-
-
-
- ggggeeeettttBBBBiiiinnnnSSSSiiiizzzzeeee(((())))
-
- double ilImgStatGetBinSize(ilImgStat *obj)
-
-
- Returns the size of each histogram bin (i.e., number of pixel values
- that fall into each bin).
-
- ggggeeeettttEEEEnnnndddd(((())))
-
- double ilImgStatGetEnd(ilImgStat *obj)
-
-
- Returns the domain upper limit of the collected histogram.
-
- ggggeeeettttHHHHiiiisssstttt(((())))
-
- unsigned long* ilImgStatGetHist(ilImgStat *obj, int chan)
-
-
- Returns the computed 1-D histogram of channel _c_h_a_n. This function
- returns a pointer to an unsigned long array that has ggggeeeettttBBBBiiiinnnnCCCCoooouuuunnnntttt()
- bins. Each bin of this histogram covers ggggeeeettttBBBBiiiinnnnSSSSiiiizzzzeeee() pixel values in
- the input image. This method will automatically compute the
- statistics if the input image or one of the controlling parameters
- has changed since the last access.
-
- ggggeeeettttHHHHwwwwEEEEnnnnaaaabbbblllleeee(((())))
-
- ilHwAccelEnable ilImgStatGetHwEnable(ilImgStat *obj)
-
-
- Returns the current state of hardware acceleration capability. It
- returns _T_R_U_E if the capability is enabled.
-
- ggggeeeettttIIIInnnnppppuuuutttt(((())))
-
- ilImage* ilImgStatGetInput(ilImgStat *obj)
-
-
- Returns the input image used as the source for statistics
- collection.
-
- ggggeeeettttLLLLiiiimmmmiiiittttssss(((())))
-
- void ilImgStatGetLimits(ilImgStat *obj, double* start,
- double* end)
-
-
- Returns the domain of the histogram function. See sssseeeettttLLLLiiiimmmmiiiittttssss() below
- for more information.
-
-
-
-
- PPPPaaaaggggeeee 4444
-
-
-
-
-
-
- iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333))))
-
-
-
- ggggeeeettttMMMMaaaaxxxx(((())))
-
- double ilImgStatGetMax(ilImgStat *obj, int c)
-
-
- Returns the maximum pixel value that appears in the current ROI and
- the input image channel given by _c. This method will automatically
- compute this value if the input image or one of the controlling
- parameters has changed since the last access.
-
- ggggeeeettttMMMMeeeeaaaannnn(((())))
-
- double ilImgStatGetMean(ilImgStat *obj, int c)
-
-
- Returns the mean value of channel _c. The mean is computed from the
- histogram rather than directly from the image data. This method
- will automatically compute this value if the input image or one of
- the controlling parameters has changed since the last access.
-
- ggggeeeettttMMMMiiiinnnn(((())))
-
- double ilImgStatGetMin(ilImgStat *obj, int c)
-
-
- Returns the minimum pixel value that appears in the current ROI and
- the input image channel given by _c. This method will automatically
- compute this value if the input image or one of the controlling
- parameters has changed since the last access.
-
- ggggeeeettttOOOOvvvveeeerrrraaaallllllllMMMMaaaaxxxx(((())))
-
- double ilImgStatGetOverallMax(ilImgStat *obj)
-
-
- Returns the maximum pixel value over all the channels.
-
- ggggeeeettttOOOOvvvveeeerrrraaaallllllllMMMMiiiinnnn(((())))
-
- double ilImgStatGetOverallMin(ilImgStat *obj)
-
-
- Returns the minimum pixel value over all the channels.
-
-
-
-
-
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 5555
-
-
-
-
-
-
- iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333))))
-
-
-
- ggggeeeettttRRRRooooiiii(((())))
-
- ilRoi* ilImgStatGetRoi(ilImgStat *obj)
-
-
- Returns the current ROI.
-
- ggggeeeettttSSSSttttaaaarrrrtttt(((())))
-
- double ilImgStatGetStart(ilImgStat *obj)
-
-
- Returns the domain lower limit of the collected histogram.
-
- ggggeeeettttSSSSttttddddDDDDeeeevvvv(((())))
-
- double ilImgStatGetStdDev(ilImgStat *obj, int c)
-
-
- Returns the standard deviation of channel _c. This value is computed
- from the histogram rather than from input image data. This method
- will automatically compute this value if the input image or one of
- the controlling parameters has changed since the last access.
-
- ggggeeeettttTTTToooottttaaaallll(((())))
-
- unsigned long ilImgStatGetTotal(ilImgStat *obj, int c)
-
-
- Returns the number of pixels used in the computation of the
- collected histogram for channel _c. This method will automatically
- compute this value if the input image or one of the controlling
- parameters has changed since the last access.
-
- iiiissssFFFFrrrroooozzzzeeeennnn(((())))
-
- int ilImgStatIsFrozen(ilImgStat *obj)
-
-
- Returns the current state of the automatic statistics recalculation
- factility. It returns _T_R_U_E when the facility is enabled.
-
- qqqqCCCCaaaallllccccSSSSttttaaaattttssss(((())))
-
- void ilImgStatQCalcStats(ilImgStat *obj, ilMpNode* parent,
- ilMpManager** pMgr)
-
-
- This method queues a request to calculate statistics for the input
- image. The _p_a_r_e_n_t iiiillllMMMMppppNNNNooooddddeeee (if not _N_U_L_L) will have this operation
- added as a dependent node. The iiiillllMMMMppppMMMMaaaannnnaaaaggggeeeerrrr for this queued operation
- will be returned in _p_M_g_r if not _N_U_L_L and can be used to wait for
-
-
-
- PPPPaaaaggggeeee 6666
-
-
-
-
-
-
- iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333))))
-
-
-
- completion, obtain status or abort the operation. For more
- information on MP synchronization, see iiiillllMMMMppppMMMMaaaannnnaaaaggggeeeerrrr(3).
-
- sssseeeettttBBBBiiiinnnnCCCCoooouuuunnnntttt(((())))
-
- void ilImgStatSetBinCount(ilImgStat *obj, int count)
-
-
- Sets the number of bins for the collected histogram to _c_o_u_n_t. If not
- explicitly set by the application, the number of bins is computed
- automatically.
-
- sssseeeettttHHHHwwwwEEEEnnnnaaaabbbblllleeee(((())))
-
- void ilImgStatSetHwEnable(ilImgStat *obj, ilHwAccelEnable enable)
-
-
- This method enables or disables the hardware acceleration capability
- based upon _e_n_a_b_l_e. If this argument is _T_R_U_E then hardware
- acceleration will be used for statistics collection if it is
- available.
-
- sssseeeettttIIIInnnnppppuuuutttt(((())))
-
- void ilImgStatSetInput(ilImgStat *obj, ilImage* in)
-
-
- Specifies the image to be used as the source for statistics
- collection.
-
- sssseeeettttLLLLiiiimmmmiiiittttssss(((())))
-
- void ilImgStatSetLimits(ilImgStat *obj, double start,
- double end)
-
-
- Sets the domain of the histogram to (_s_t_a_r_t, _e_n_d). Pixel values in
- the input image that exceed these limits will be clamped (i.e.,
- values < _s_t_a_r_t will appear in the first bin and values > _e_n_d will
- appear in the last bin). By default, the domain is taken from the
- input image's range (see _g_e_t_M_i_n_V_a_l_u_e() and _g_e_t_M_a_x_V_a_l_u_e() of
- iiiillllIIIImmmmaaaaggggeeee(3)).
-
- sssseeeettttRRRRooooiiii(((())))
-
- void ilImgStatSetRoi(ilImgStat *obj, ilRoi* roi, int xoffset,
- int yoffset)
-
-
- Sets the region of interest (ROI) of the input image to _r_o_i.
- Statistics that are subsequently collected will only include those
- pixels that reside within this ROI. The offset of the ROI within the
-
-
-
- PPPPaaaaggggeeee 7777
-
-
-
-
-
-
- iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllIIIImmmmggggSSSSttttaaaatttt((((3333))))
-
-
-
- input image is specified by _x_o_f_f_s_e_t and _y_o_f_f_s_e_t. See iiiillllRRRRooooiiii(3) for
- more information on ROIs.
-
- sssseeeettttZZZZ(((())))
-
- void ilImgStatSetZ(ilImgStat *obj, int z, int nz)
-
-
- Specifies the z bounds over which statistics are computed where _z is
- the origin of this bound and _n_z_P _i_s _t_h_e _e_x_t_e_n_t. _B_y _d_e_f_a_u_l_t _t_h_i_s
- _b_o_u_n_d_a_r_y _i_s _d_e_f_i_n_e_d _b_y _t_h_e _n_u_m_b_e_r _o_f _z _p_l_a_n_e_s _p_r_e_s_e_n_t _i_n _t_h_e _i_n_p_u_t
- _i_m_a_g_e.
-
- IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
- IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllLLLLiiiinnnnkkkk
- ilLinkClearSet(), ilLinkClearStatus(), ilLinkGetDescription(),
- ilLinkGetDirectParent(), ilLinkGetDisabledIndex(), ilLinkGetFloatProp(),
- ilLinkGetGenerationID(), ilLinkGetIntProp(), ilLinkGetNumChildren(),
- ilLinkGetNumParents(), ilLinkGetParent(), ilLinkGetPtrProp(),
- ilLinkGetRelatedChild(), ilLinkGetRelatedDelete(),
- ilLinkGetRelatedType(), ilLinkGetStatus(), ilLinkIsAllowed(),
- ilLinkIsAltered(), ilLinkIsEnabled(), ilLinkIsRelated(), ilLinkIsSet(),
- ilLinkRemoveParent(), ilLinkRemoveProp(), ilLinkSetDescription(),
- ilLinkSetDisabledIndex(), ilLinkSetEnabled(), ilLinkSetParent(),
- ilLinkSetProp(), ilLinkSetRelatedDelete(), ilLinkSetRelatedType()
-
-
- SSSSEEEEEEEE AAAALLLLSSSSOOOO
- ilImage, ilLink, ilMpManager, ilRoi
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 8888
-
-
-
-